Item Properties

An item, also known as a tag or signal, represents a data value of some sort. Either originating from an external system (PLC, DCS, etc.), or calculated/derived from such values within the Apis environment.

Item types

There are three main item types; scalar values, vector values and matrix values.

A scalar value may typically be a flow signal, temperature, etc. from an external system. A vector value typically is a spectrum from a NIR instrument or a control vector in a model based predictive control (MPC) system, and basically is a one-dimensional array. A matrix value typically is a system matrix in an MPC system, and basically is a two-dimensional array.

Supported data values

Apis Honeystore supports all common data types, ie. 32/64 bits floating point values, 8/16/32/64 bits signed/unsigned integer values, boolean values, date values, string values, as well as arrays (vectors/matrices) of all these types.

Apis Honeystore items have several properties (also called attributes) associated with them. Some of these properties are mandatory for all items. Other properties may apply or exist only for some items, this apply to properties like description, engineering units, normal minimum/maximum values etc. The properties are added to items and maintained by the application writing to the database, typically an ApisLoggerBee module within the Apis Hive framework.

Mandatory properties

NameDescription
HandleAn internal handle (placeholder) of the item.
ItemIDThe name of the item. This name is unique within one database.
DatatypeThe data type of the item, eg. floating point, boolean, string, etc.
Recordtype

The record type of the item. This tells what and how the item is sampled. Three types are defined:

  • Sampled: Only data values are stored at a regular sample interval
  • Sampled with quality: Data values and quality information are stored at a regular sample interval
  • Eventbased with quality: Data values, quality information are stored each time the value or quality changes
ResolutionFor the two Sampled record types; the sampling interval of the item. For the Eventbased with quality recordtype: the minimum period between two subsequent samples.
HistoryLengthThe minimum time horizon of the trend of an item, meaning that trend data will not be deleted/overwritten until at least the time period specified by this attribute has elapsed.
SampleSizeThe uncompressed size of one data sample in bytes.

Optional properties that may occur

NameDescription
DescriptionA description of the item
Engineering unitSpecifies the label to use in displays to define the units for the item (e.g., kg/sec)
Normal maximumThe upper limit for the normal value range for the item. Used for trend display default scaling etc.
Normal minimumThe lower limit for the normal value range for the item. Used for trend display default scaling etc.
PDS Engineering UnitThe PDS Engineering unit (engineering unit) associated with this item. This attribute only have meaning inside an Apis Click & Trace™ configuration
DisplayOperator display associated with the item
HiLimitThe Hi alarm limit of this item
HiHiLimitThe HiHi alarm limit of this item
LoLimitThe Lo alarm limit of this item
LoLoLimitThe LoLo alarm limit of this item
UpperBoundThe upper bound of vector item
LowerBoundThe lower bound of vector item
ArgumentItemThe argument item of this item, meaning is client specific